home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL / glgettexlevelparameter.z / glgettexlevelparameter
Encoding:
Text File  |  1998-10-20  |  19.2 KB  |  200 lines
  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvv,,,, ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvv - return texture
  10.      parameter values for a specific level of detail
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      void ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvv( GLenum _t_a_r_g_e_t,
  15.                                     GLint _l_e_v_e_l,
  16.                                     GLenum _p_n_a_m_e,
  17.                                     GLfloat *_p_a_r_a_m_s )
  18.      void ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvv( GLenum _t_a_r_g_e_t,
  19.                                     GLint _l_e_v_e_l,
  20.                                     GLenum _p_n_a_m_e,
  21.                                     GLint *_p_a_r_a_m_s )
  22.  
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _t_a_r_g_e_t  Specifies the symbolic name of the target texture, either
  26.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD,
  27.              GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD____EEEEXXXXTTTT,
  28.              GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD____EEEEXXXXTTTT, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD____EEEEXXXXTTTT, or
  29.              GGGGLLLL____DDDDEEEETTTTAAAAIIIILLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD____SSSSGGGGIIIISSSS.
  30.  
  31.      _l_e_v_e_l   Specifies the level-of-detail number of the desired image.  Level
  32.              0 is the base image level.  Level n is the nth mipmap reduction
  33.              image.
  34.  
  35.      _p_n_a_m_e   Specifies the symbolic name of a texture parameter.
  36.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____WWWWIIIIDDDDTTTTHHHH, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____HHHHEEEEIIIIGGGGHHHHTTTT, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____DDDDEEEEPPPPTTTTHHHH____EEEEXXXXTTTT,
  37.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTTSSSS, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEERRRRNNNNAAAALLLL____FFFFOOOORRRRMMMMAAAATTTT,
  38.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBOOOORRRRDDDDEEEERRRR, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEEDDDD____SSSSIIIIZZZZEEEE, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEEDDDD____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  39.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  40.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  41.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  42.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____SSSSIIIIZZZZEEEE, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  43.              GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____SSSSIIIIZZZZEEEE, and GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT are
  44.              accepted.
  45.  
  46.      _p_a_r_a_m_s  Returns the requested data.
  47.  
  48. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.      ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr returns in _p_a_r_a_m_s texture parameter values for a
  50.      specific level-of-detail value, specified as _l_e_v_e_l.  _t_a_r_g_e_t defines the
  51.      target texture, one of GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD,
  52.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD____EEEEXXXXTTTT,
  53.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD____EEEEXXXXTTTT, GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD____EEEEXXXXTTTT, or
  54.      GGGGLLLL____DDDDEEEETTTTAAAAIIIILLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD____SSSSGGGGIIIISSSS.
  55.  
  56.      GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE is not really descriptive enough.  It has to report
  57.      the largest square texture image that can be accommodated with mipmaps
  58.      and borders, but a long skinny texture, or a texture without mipmaps and
  59.      borders, may easily fit in texture memory.  The proxy targets allow the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      user to more accurately query whether the GL can accommodate a texture of
  75.      a given configuration.  If the texture cannot be accommodated, the
  76.      texture state variables, which may be queried with
  77.      ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr, are set to 0.  If the texture can be
  78.      accommodated, the texture state values will be set as they would be set
  79.      for a non-proxy target.
  80.  
  81.      _p_n_a_m_e specifies the texture parameter whose value or values will be
  82.      returned.
  83.  
  84.      The accepted parameter names are as follows:
  85.  
  86.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____WWWWIIIIDDDDTTTTHHHH
  87.                _p_a_r_a_m_s returns a single value, the width of the texture image.
  88.                This value includes the border of the texture image. The
  89.                initial value is 0.
  90.  
  91.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____HHHHEEEEIIIIGGGGHHHHTTTT
  92.                _p_a_r_a_m_s returns a single value, the height of the texture image.
  93.                This value includes the border of the texture image. The
  94.                initial value is 0.
  95.  
  96.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEERRRRNNNNAAAALLLL____FFFFOOOORRRRMMMMAAAATTTT
  97.                _p_a_r_a_m_s returns a single value, the internal format of the
  98.                texture image.
  99.  
  100.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____DDDDEEEEPPPPTTTTHHHH____EEEEXXXXTTTT
  101.                _p_a_r_a_m_s returns a single value, the depth of the texture image.
  102.                This value includes the border of the texture image.
  103.  
  104.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTTSSSS
  105.                _p_a_r_a_m_s returns a single value, the level-of-detail's component
  106.                as it was specified by the user.
  107.  
  108.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBOOOORRRRDDDDEEEERRRR
  109.                _p_a_r_a_m_s returns a single value, the width in pixels of the
  110.                border of the texture image. The initial value is 0.
  111.  
  112.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEEDDDD____SSSSIIIIZZZZEEEE,
  113.  
  114.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEEDDDD____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  115.  
  116.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE,
  117.  
  118.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____GGGGRRRREEEEEEEENNNN____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  119.  
  120.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE,
  121.  
  122.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBLLLLUUUUEEEE____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE,
  141.  
  142.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____AAAALLLLPPPPHHHHAAAA____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  143.  
  144.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____SSSSIIIIZZZZEEEE,
  145.  
  146.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT,
  147.  
  148.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____SSSSIIIIZZZZEEEE, or
  149.  
  150.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____SSSSIIIIZZZZEEEE____EEEEXXXXTTTT
  151.                The internal storage resolution of an individual component.
  152.                The resolution chosen by the GL will be a close match for the
  153.                format requested by the user with the component argument of
  154.                ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111dddd, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222dddd, or ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDDEEEEXXXXTTTT. These values
  155.                for _p_n_a_m_e query the format chosen by the GL, while
  156.                GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEERRRRNNNNAAAALLLL____FFFFOOOORRRRMMMMAAAATTTT and GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTTSSSS are used
  157.                to query the value requested by the user.
  158.  
  159. NNNNOOOOTTTTEEEESSSS
  160.      If an error is generated, no change is made to the contents of _p_a_r_a_m_s.
  161.  
  162.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____IIIINNNNTTTTEEEERRRRNNNNAAAALLLL____FFFFOOOORRRRMMMMAAAATTTT is only available if the GL version is 1.1 or
  163.      greater. In version 1.0, use GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTTSSSS instead.
  164.  
  165.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD and GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD are only available if the GL
  166.      version is 1.1 or greater.
  167.  
  168.      tttteeeexxxxttttuuuurrrreeee3333DDDD will be present if GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD____EEEEXXXXTTTT and
  169.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD____EEEEXXXXTTTT are supported.
  170.  
  171. EEEERRRRRRRROOOORRRRSSSS
  172.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t, _p_n_a_m_e, or _p_a_r_a_m_s is not an
  173.      accepted value.
  174.  
  175.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  176.  
  177.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log max, where
  178.                                                                    2
  179.      max is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  180.  
  181.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr is executed
  182.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  183.      ggggllllEEEEnnnndddd.
  184.  
  185.  
  186. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  187.      ggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  188.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxEEEEnnnnvvvv, ggggllllTTTTeeeexxxxGGGGeeeennnn,
  189.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDDEEEEXXXXTTTT, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr,
  190.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.